home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-06 / btfl144.zip / README.BTF < prev    next >
Text File  |  1993-03-21  |  17KB  |  361 lines

  1.                   BTFILER Installation Instructions/
  2.                           Last minute notes.
  3.  
  4.  
  5. All BTFILER files are found in a file called BTFL14.ZIP.  You
  6. should extract all files from the ZIP file and make sure all
  7. files are found on the PATH.
  8.  
  9. Note that the program currently has been tested with variable
  10. length files as large as 25000 bytes without unpleasant side
  11. effects on a system with 540 K of free memory.  The only problem
  12. is that less than a full screen of data will appear.
  13.  
  14. An undocumented feature is that while opening a file, the
  15. directories specified by the environment variable BTFILEPATH are
  16. also searched.
  17.  
  18. If you have any trouble seeing the menus, try resetting the
  19. colors (Set Colors under the Options menu).  Also, a new file is
  20. now sent, CINSTALL.DAT.  This will install the standard green
  21. screen color set.  I ran into some problems with folks having
  22. strange screen problems.  Very odd stuff.
  23.  
  24. Another troubleshooting tip:  If you are having a problem with
  25. running BTFILER, Please(!) try loading BTRIEVE.EXE with the /E
  26. parameter that causes BTRIEVE not to use extended (or is that
  27. expanded?<G>) memory.  Many a problem has been eliminated by
  28. that advice.  Also, if you have some application that runs with
  29. Btrieve and BTFILER does not run, try to determine what start-up
  30. parameters the working system uses, and load BTRIEVE the exact
  31. same way before going into BTFILER.
  32.  
  33. If this software is more than 9 months old, please send you name
  34. and mailing address, along with a blank diskette and postage for
  35. 2 ounces and I will send you the latest version of the
  36. software.  I understand that shareware tends to live on forever,
  37. but I would like you to have the best possible impression of my
  38. work, and while I am not currently aware of any bugs, I can
  39. pretty much assure you that the software will be even better 9
  40. months down the line than it is now.  The address is:
  41.  
  42.                   Access Microsystems Inc.
  43.                   404 Midstreams Road
  44.                   Brick, New Jersey  08724
  45.  
  46. Thank you!
  47.  
  48.                               What's New?
  49.  
  50. 03/21/93  Enhance Index Testing.  Allow selection of individual
  51.           index or all indices, also report more on the failure
  52.           (reason, key number, record number.  Information logged
  53.           to log file if so desired, as well.  (see 11/25/92 note).
  54.  
  55.           Change menu system.  ALT plus a key such as 'F' for FIle,
  56.           'H' for Help, 'O' for Options, will bring you to that menu
  57.           from any other menu.
  58.  
  59.           Release 1.44
  60.  
  61. 01/16/93  Fix BTFILER.MSK to allow field edit to work properly
  62.           with decimal places.
  63.  
  64. 01/02/92  Made changes to allow for proper use with data only
  65.           files.
  66.  
  67. 12/29/92  Re-compiled ad resolved unexplained hang-up problem
  68.           with some files.
  69.  
  70. 12/26/92  Add support for F9 key in Edit.  F9 will allow you to
  71.           pick a place in a file, define a field type, length and
  72.           decimals and display and edit a binary value.
  73.           Release 1.43
  74.  
  75. 12/09/92  Fix problem with export of ASCII.
  76.  
  77. 12/03/92  Fix additional index tests, had a problem with ZSTRINGS
  78.  
  79. 11/30/92  Include additional test for index that differs from
  80.           data.  This should, of course, not occur, but that's
  81.           what testing is for!
  82.  
  83. 11/25/92  Finalize logging for reporting results of test/rebuild.
  84.           All messages that indicate success include "OK" (not
  85.           the quotes, just two letters).  All message that indicate
  86.           failure include "FAIL".  To use: use a /L or /L:LOGFILE.EXT
  87.           parameter to BTFILER.  '/L' results in information
  88.           appended to BTFILER.LOG in current working directory.
  89.           VERSION 1.42!
  90.  
  91. 11/04/92  Minor touch.  If you enter a filename containing '*'
  92.           or '?' and no file like that exists, the program now
  93.           tells you so.  This will make the program a bit more
  94.           usable.
  95.  
  96. 10/29/92  Fix bug with import of unformatted ASCII when "Open
  97.           Destination in Accelerated Mode" checked.  (Thanks
  98.           to Paul at Posse, Inc.)
  99.  
  100. 08/28/92  Add BTCOPY.BAT batch file, and fix BTFILER to allow
  101.           keystroke file to work correctly.
  102.  
  103. 08/21/92  Make the parsing (reading, interpreting) of of .INX
  104.           files more relaxed.  Allow empty lines (all spaces) to
  105.           be treated as comments, rather than causing errors.
  106.           Fix up interpretation of very large unsigned numbers
  107.           in import and export.
  108.  
  109. 08/07/92  Break error message on create I/O error into two line so
  110.           screen does not get messed up if long pathnames are used.
  111.           Also, change behavior of string and lstring export:  Convert
  112.           embedded NULLs to spaces.
  113.  
  114. 08/03/92  Add support for Pascal 6 byte REAL (Turbo Pascal) for import
  115.           and export.
  116.  
  117. 07/04/92  Compile under Borland C++ 3.1
  118.           Fix bug that caused hang during startup SOMETIMES
  119.           if PATH was longer than 100 bytes.
  120.  
  121. 06/19/92  Fix minor problem with NUMERIC import.
  122.  
  123. 06/07/92  Fix problem with DATE Import/Export.
  124.  
  125. 06/03/92  Fix problem with BFLOAT import.  Was not working
  126.           correctly for all valid sizes.
  127.  
  128. 06/01/92  Add HEX Search option on View menu during browse.  To
  129.           use, simply choose the HEX search option, fill in the
  130.           info, and then press ESC.  Answer the question about
  131.           global search, and the info will be searched for.
  132.  
  133. 05/28/92  We will ship no software before its time.  IT'S TIME!
  134.           Final strnageness removed with BFLOAT export, and
  135.           refine Btrieve Page Size Calculator.
  136.  
  137. 05/17/92  Add Comma delimited import as an option on a new
  138.           Import menu.  Still BETA, not yet fully tested.
  139.  
  140. 05/14/92  Add Comma delimited export as an option on a new
  141.           Export menu.  This becomes BETA Version 1.40!  Final
  142.           version 1.40 will have comma delimited import as well.
  143.  
  144. 04/21/92  Fix problem where BREQUEST version number was not
  145.           recognized when BREQUEST was loaded by BTFILER.
  146.           Further, made sure BREQUEST and BTFILER better co-exist.
  147.           (Internal testing).
  148.  
  149. 04/20/92  Change menu structure around the more exotic file
  150.           recovery methods.  Under Test/Rebuild Btrieve File
  151.           create an additional sub menu called when Advanced
  152.           File Recovery is selected.  This is to try and ensure
  153.           that these file recovery tools do not get overused.
  154.           They are both capable of doing some harm, and should
  155.           almost never be needed.  Also, a warning screen has
  156.           been placed in front of both options (Recover EVERY
  157.           POSSIBLE Record and Rebuild Header).
  158.  
  159. 04/17/92  Add FULL recovery, an exaustive recovery technique
  160.           that tries EVERY possible record position, and even if
  161.           Btrieve returns a status 2, the program then uses DOS
  162.           (fixed length files with no owner set, so as to ensure
  163.           that we don't try to read encrypted data) to read the
  164.           data at the position we think it might be.  We don't
  165.           even touch files with data compression, blank
  166.           truncation, or key only files.  There are limits!
  167.  
  168.           Use of this on a damaged file will probably require
  169.           some manual intervention to delete "extra" records,
  170.           but it beats trying to re-enter the data! (Thanks to:
  171.           Davin Church [NOVDEV] for some of the ideas about this
  172.           recovery method).
  173.  
  174. 04/16/92  Changed the way that some operations (pack and copy)
  175.           get records from the source file.  Formerly used Key
  176.           0, now use physical positioning.  (Thanks to: Davin
  177.           Church [NOVDEV]).
  178.  
  179. 04/03/92  Add ability to use INSERT and DELETE in the Hex/ASCII
  180.           edit screen.  Also add F1 support in Hex/ASCII edit.
  181.  
  182. 04/02/92  Add support for Header Rebuild.  PLEASE NOTE THAT THIS
  183.           IS NOT FOR FOLKS WHO DON'T KNOW WHAT THEY ARE DOING!
  184.           In any case, the Rebuild Header option on Test/Rebuild
  185.           on the main File menu should only be used after you
  186.           have tried to do a normal rebuild.  To rebuild the
  187.           header, you MUST have a btrieve file available with
  188.           EXACTLY the same file structure as the one whose
  189.           header you wish to rebuild.  After the rebuild of the
  190.           header completes successfully, you will be brought to
  191.           the file rebuild screen with the file to rebuild
  192.           already filled in.  Also, the drive where the work
  193.           file should be built during a rebuild can also be set
  194.           now to allow for the rebuild of a file that is larger
  195.           than the free space on the disk where the file
  196.           resides.  REMEMBER: During header rebuilding you can
  197.           just as easily damage a good file as fix a bad one!
  198.           You should make a backup of the file before you try
  199.           the header rebuild so you can try other methods if
  200.           BTFILER fails.
  201.  
  202.           Also, there have been several small fixes to allow for
  203.           better recovery of variable length files.
  204.  
  205. 03/27/92  Fix odd display of % Utilization when file has 0 records.
  206.  
  207. 03/26/92  Change behavior of abandon during COPY operation when
  208.           ESC pressed.  Also add ability to use PREALLOCATION=
  209.           line (optional just after FREE SPACE THRESHOLD=) in
  210.           .BTB BTrieve Build description file.  Allow 0 value in
  211.           FREE SPACE THRESHOLD= line to allow 0 free space
  212.           threshold.
  213.  
  214. 03/25/92  Open Btrieve "source" files in various places in Read Only
  215.           mode, so that the file is more likely to be able to be read.
  216.  
  217. 03/19/92  Add color customization, ensure colors updated properly
  218.           when using a program like Carbon Copy with differing
  219.           video adaptors.  Several minor tweaks.  Version 1.31.
  220.  
  221. 03/15/92  Add error reporting to some areas not previously
  222.           reporting errors.  (For instance, when you
  223.           "View Begining with").
  224.  
  225.           Place up-to-date copy of BTFILER.MSK into ZIP.
  226.  
  227. 02/29/92  Fix problem with packing of files with duplicates
  228.           allowed in key 0.  BTFILER was reading the records
  229.           just fine, but was adding them to the packed file
  230.           in such a way that the duplicates in key 0 were
  231.           causing UPDATES, not INSERTS.  "Always Insert" flag
  232.           added to PACK and COPY screen.  (Thanks to Mike Trill
  233.           from CompuServe for pointing this one out.)  Also,
  234.           add COPY option for one stop export/import into new
  235.           format.
  236.  
  237.           (In the PM)  Cause a clone to be built in copy if
  238.           destination does not exist.
  239.  
  240. 02/26/92  Fix silly display problem when last record in file
  241.           deleted.
  242.  
  243. 02/19/92  Fix status 22 occuring in error on variable length
  244.           records.  (Internal testing).
  245.  
  246. 02/17/92  (Happy Washington's Birthday!)  Little changes
  247.           resulting from extensive testing.  Expand size of
  248.           possible keystroke file to 200.  Make the
  249.           /c:myconfig.cf2 file the file written to, if
  250.           specified on the command line.  Also add ability to
  251.           specify MANUAL as a key type.
  252.  
  253.           First general release of 1.30.
  254.  
  255. 02/11/92  New version fixes.  Fix display problems for lines
  256.           shorter than 80, fix odd behavior when last record is
  257.           deleted (again...this reared it's ugly head before...)
  258.           and ensure that highlighting does not disappear during
  259.           record delete.  Still BETA, for brave souls who do
  260.           frequent backups (just in case!).
  261.  
  262. 02/07/92  New Version!  Ver. 1.30 adds ability to use a file
  263.           of keystrokes to run the program (Batch mode).  See
  264.           BTCLONE.BAT and BTRESET.BAT for info on creating files.
  265.           Also, the open mode of the files Browsed/Edited can be
  266.           set.  In addition, the default filename mask can be set.
  267.           If you already have edited a file, you can get back to
  268.           the default filename mask by pressing <F9> in fields
  269.           where the status line says you can.  You can also
  270.           clear out any data entry field by pressing <CTRL-C>.
  271.           There are also some memory allocation fixes.
  272.  
  273.           Features added include: Transactions can be started,
  274.           abandoned or finished out properly (although the
  275.           program in BETA will allow you to try to do silly
  276.           things while in a transaction, and simply fail with an
  277.           error message rather than letting you know up front.)
  278.           Supplemental index addition is now supported.  See
  279.           SAMPLE.BTS (Btrieve Supplemental) for details.
  280.  
  281.           BETA RELEASE!
  282.  
  283. 01/27/92  Fix problem that happens during PACK with SHARE
  284.           loaded.  PACK works fine, but error was reported
  285.           at the end of the process, and temporary files were
  286.           not deleted.  (Thanks to: Carl in Orlando).
  287.  
  288. 01/22/92  Bug fix.  Fixed problem with screen display if last
  289.           record on screen deleted.  Problem might have just
  290.           been added with the 1/20/92 change to the program.
  291.           (internal testing).
  292.  
  293. 01/20/92  Bug Fixes.  Also, change version number to 1.21 to
  294.           ensure I will know if you have the latest version
  295.           if you call.  Fix problem with saving of variable length
  296.           records.  If you edited the first record in a variable
  297.           length file, made no changes, and edited that record
  298.           again, the record length would be reported as the
  299.           maximum record length specified in the "Set Misc.
  300.           Parameters" section.  (Thanks to: Brian Levine of
  301.           Orlando)  Also, remove "<ESC> to Exit Help" message when
  302.           you have exited help.  (Thanks to: Steve Checkosky in
  303.           Syracuse)  Fixed memory allocation bug while deleting
  304.           records.  (Internal testing).
  305.  
  306.           Along the way, added a feature that allow for setting
  307.           of length of a variable length record when you go to
  308.           save it.  Uses current length as default, and will use
  309.           current length if length is too long (longer than
  310.           Longest variable length record setting in "Set Misc.
  311.           Parameters") or too short (shorter than fixed length
  312.           portion of record).
  313.  
  314.           Also, see the documentation regarding ways to register
  315.           BTFILER if you must use a credit card.  You may do so
  316.           through CompuServe or the toll free number listed in
  317.           the documentation.
  318.  
  319. 01/17/92  Bug fixes/Silly Spelling error fix.  Fixed problem that
  320.           caused an Abnormal Program Termination if statistics
  321.           were requested on a file with 0 records.  (Thanks to:
  322.           Jamie Bozzo from Mass.)  Fixed spelling errors in
  323.           BTFILER.MNU and BTFILER.HLP.
  324.  
  325. 01/04/92  Bug fixes.  Fixed problem that could cause NULL Pointer
  326.           error (Thanks to: Brian Levine of Orlando) and problem
  327.           that could allow editing of the byte in memory just
  328.           BEFORE the buffer for a Btrieve record (internal testing).
  329.  
  330. 12/20/91  NEW VERSION (1.20).  Help available when BTRIEVE
  331.           errors occur, explanations of BTRIEVE errors available
  332.           while listing errors.  New features include Set and
  333.           Clear owner, Statistics on a Btrieve file,
  334.           improvements to the Import/Export utility (a late
  335.           version 1.10 add-in).  Print documantation from the
  336.           menu.  Also, Btrieve Page Size Calculator, Create
  337.           Btrieve fiels for ASCII BTrieve Build (BTB) description
  338.           file.  Like BUTIL -CREATE but with MUCH better error
  339.           reporting!
  340.  
  341. 12/05/91  Various fixes.  Fixed some oddness if the menu
  342.           control, fixed a problem with error reporting (changes
  343.           to BTFILER.BER), and made the HEX/ASCII edit routine
  344.           allow display and edit of 256 bytes at a time, double
  345.           the previous display.
  346.  
  347.           Changed system behavior during EXPORT.  Prompts user
  348.           to see if s/he wants to delete destination ASCII file
  349.           before doing export, or export is abandoned.  This was
  350.           needed since there could be problems if the
  351.           destination ASCII file was created by BUTIL -RECOVER,
  352.           since this results in a literal control-Z written to
  353.           the file, which will cause problems for BTFILER during
  354.           Import.
  355.  
  356.           While browsing a file, the HOME and END keys work to
  357.           put you at the beginning and the end of the file,
  358.           respectively.
  359.  
  360. 12/01/91  Import/Export is added to the FILE menu.
  361.